home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / qes30.zip / QESSUMRY.DOC next >
Text File  |  1988-09-11  |  43KB  |  1,032 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                                  QESSUMRY.EXE
  17.                                       3.0
  18.                              Release Date 09/11/88
  19.  
  20.  
  21.                               Copyright (c) 1988
  22.                                 R. Mike Worley
  23.                                  Boise, Idaho
  24.  
  25.  
  26.                                TABLE of CONTENTS
  27.  
  28.  
  29. REGISTRATION & WARRANTY  . . . . . . . . . . . . . . . . . . . . . . . . .    1
  30.  
  31. PROGRAM SUMMARY and HISTORY  . . . . . . . . . . . . . . . . . . . . . . .    2
  32.  
  33. NEW FEATURES IN QESSUMRY 3.0 . . . . . . . . . . . . . . . . . . . . . . .    3
  34.  
  35. EXAMPLES & FILE EXTENSION SUMMARY  . . . . . . . . . . . . . . . . . . . .    4
  36.  
  37. DEFINING THE QUESTIONS . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  38.  
  39. RUNNING THE PROGRAM  . . . . . . . . . . . . . . . . . . . . . . . . . . .    6
  40.  
  41. OUTPUT OPTIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  42.      [A]SCII File  . . . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  43.      (P)rinter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  44.      (D)atabase File . . . . . . . . . . . . . . . . . . . . . . . . . . .    7
  45.      (Q)uestions & Answers . . . . . . . . . . . . . . . . . . . . . . . .    8
  46.           Supplying "Correct" Answers  . . . . . . . . . . . . . . . . . .    8
  47.           Supplying an Explanation to Questions  . . . . . . . . . . . . .    9
  48.           Format of <filename>.EXP . . . . . . . . . . . . . . . . . . . .    9
  49.      (U)ser Response Statistics  . . . . . . . . . . . . . . . . . . . . .    9
  50.  
  51. Overwriting Output Files . . . . . . . . . . . . . . . . . . . . . . . . .   10
  52.  
  53. Explanation of Appendices  . . . . . . . . . . . . . . . . . . . . . . . .   10
  54.  
  55. Appendix A - Sample Definition File  . . . . . . . . . . . . . . . . . . .   11
  56.  
  57. Appendix B - Sample Answer Files . . . . . . . . . . . . . . . . . . . . .   13
  58.  
  59. Appendix C - Sample Explanation File . . . . . . . . . . . . . . . . . . .   14
  60.  
  61. Appendix D - Sample ASCII Output File  . . . . . . . . . . . . . . . . . .   15
  62.  
  63. Appendix E - Sample Delimited Database Output File . . . . . . . . . . . .   17
  64.  
  65. Appendix F - Sample Question & Answer Summary  . . . . . . . . . . . . . .   18
  66.  
  67. Appendix G - Sample User Response Statistics . . . . . . . . . . . . . . .   22
  68.  
  69. REGISTRATION FORM  . . . . . . . . . . . . . . . . . . . . . . . . . . . .   23
  70.  
  71. INDEX  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   24
  72.  
  73.  
  74.  
  75.                             REGISTRATION & WARRANTY
  76.  
  77.      QESSUMRY 3.0 is not warranted in any way, nor is it applicable to any
  78. specific application.  The user is solely responsible for any and all conse-
  79. quences resulting from the use of this program.  There are no known bugs in the
  80. program, but that doesn't mean you might not find one.
  81.  
  82.      QESSUMRY 3.0 is offered under the Shareware concept - it is not free
  83. software.  You are free to try it to determine if it will meet your needs, and
  84. you are encouraged to upload program and documentation to bulletin boards.  If
  85. you continue to use this program, you must register.  To register, complete the
  86. registration form on the last page of this documentation and send it to the
  87. address listed.  The registration fee for QESSUMRY 3.0 is $15.00.
  88.  
  89.  
  90.      BBS Sysops may distribute this program on their systems, subject to the
  91. following conditions: 
  92.  
  93.           1 - The program, documentation, and associated files are distributed
  94.           as a package. 
  95.  
  96.           2 - No modifications are made to the program or documentation. 
  97.  
  98.           3 - No fee is charged for distribution. 
  99.  
  100.  
  101.  
  102.                           PROGRAM SUMMARY and HISTORY
  103.  
  104.      QESSUMRY 3.0 is a program to summarize data from bulletin board question-
  105. naires developed for RBBS-PC.  The program will ignore questions requiring a
  106. text response, provided individual the questions are named as outlined below. 
  107. It will also skip questions for which there have been no responses, as
  108. sometimes occurs when the questionnaire follows different paths depending on
  109. answers to previous questions.
  110.  
  111.      QESSUMRY 3.0 will tally the number of responses for multiple choice and
  112. yes/no questions, and will calculate a response percentage for each choice.
  113. The basic tally and percentage can be output to a ASCII (Text) File, a Printer,
  114. or to a Delimited Data File for use with database programs. 
  115.  
  116.      QESSUMRY 3.0 can also create a special text file which integrates the
  117. actual questions from the questionnaire .DEF file with the response summaries,
  118. along with an indication of "correct" answers to questions, if appropriate.  
  119. QESSUMRY 3.0 provides the additional ability to incorporate explanations of
  120. "correct" answers to questions, either through keyboard input of from a data
  121. file.
  122.  
  123.      QESSUMRY started as QESTALLY, which was released in February, 1988.  Some
  124. users requested improvements to the program to make it more versatile in
  125. output.  The delimited data file output was immediately added, but before the
  126. revision was released, I noted a need to integrate the actual questions from
  127. the <filename>.DEF file with the answer summaries.  This creates a bulletin
  128. which shows the reader the question, the correct answer, and the summary of
  129. responses.  The revision was major enough to warrant renaming the program, and
  130. thus QESSUMRY was born.
  131.  
  132.                          NEW FEATURES IN QESSUMRY 3.0
  133.  
  134. *    The program now recycles.  Previous versions could only create one output
  135.      each time the program was run.  3.0 allows continuous operation until <CR>
  136.      is pressed at the initial prompt.
  137.  
  138. *    It is no longer necessary for "correct" answers to be provided to
  139.      questions before explanations may be provided.  This recognizes the
  140.      occasional need to further clarify questions or to indicate the "most
  141.      right" answer to an opinion poll.
  142.  
  143. *    If no answer file is present, and one is desired, the user now has the
  144.      option to output answers typed on the screen to a file for future use. 
  145.      (<filename>.ANS file)
  146.  
  147. *    Explanations to questions, typed on the screen, may now be output to a
  148.      file for future use.  (<filename>.EXP file)
  149.  
  150. *    Individual user's percentages of correct answers, and questions missed by
  151.      each user responding to the questionnaire, may now be summarized and
  152.      output to a file.  (<filename>.URS file)
  153.  
  154. *    The program now determines the number of possible answers to each question
  155.      and configures the tally and percentage outputs to the proper number of
  156.      answers.
  157.                        EXAMPLES & FILE EXTENSION SUMMARY
  158.  
  159.      Throughout this documentation, we will refer to several types of files. 
  160. Examples of all files, except the .DAT (data) file, are listed in the appen-
  161. dices.  We have used an actual questionnaire called TRIVIA.DEF.  This question-
  162. naire represents the most complex type, one with "correct" answers and explana-
  163. tions of why those answers are correct. 
  164.  
  165.      The following file extensions are used at various times by QESSUMRY 3.0. 
  166. All extensions are preceded by the questionnaire filename, which is designated
  167. in the documentation as <filename>.  The <filename> may be any 1 - 8 character
  168. name valid with MS-DOS, but must be the same for all questionnaire files.
  169.  
  170.  
  171. <filename>.ANS      File containing "correct" answers to questions.  Optional
  172.                file - if it is not available, QESSUMRY will prompt for respon-
  173.                ses.  [Created by sysop]
  174.  
  175.  
  176. <filename>.DAT      Data file output by RBBS, containing each respondent's name
  177.                and answers to questions.  [Created by RBBS - Sysop must supply
  178.                the data file name during the creation of <filename>.DEF]
  179.  
  180.  
  181. <filename>.DEF      Questionnaire definition file.  This must be created as
  182.                specified in the RBBS-PC 15.1x or 16.1A documentation.  [Must be
  183.                created by the sysop]
  184.  
  185.  
  186. <filename>.DTA      File containing total number of responses to each question
  187.                and the number of responses to each option for each question. 
  188.                Data is delimited by commas for use with database programs. 
  189.                [Created by QESSUMRY]
  190.  
  191.  
  192. <filename>.EXP      File containing explanations for questions.  This may
  193.                include explanations of "correct" answers, or definition of
  194.                "most right" responses to opinion polls.Optional file.  [Created
  195.                by sysop following guidelines below, or created by QESSUMRY]
  196.  
  197.  
  198. <filename>.SUM      File created from the Summarize (Q)uestions & Answers
  199.                option of QESSUMRY.  Contains the text of questions from the
  200.                <filename>.DEF file and the answer summary for each question. 
  201.                Can also contain a "correct" answer indicator and explanation
  202.                for each question.  [Created by QESSUMRY]
  203.  
  204.  
  205. <filename>.TXT      File containing a summary of each question, the number of
  206.                responses to each option, and the percentage of respondents
  207.                choosing each option.  [Created by QESSUMRY]
  208.  
  209. <filename>.URS      File containing each respondent user's name, percentage of
  210.                correct answers, and a listing of questions to which the
  211.                respondent gave incorrect answers.  <filename>.ANS be present
  212.                and properly created for this file to be created.  [Created by
  213.                QESSUMRY]
  214.  
  215.  
  216.  
  217.                             DEFINING THE QUESTIONS
  218.  
  219.      The RBBS-PC questionnaire is developed according to the directions in the
  220. RBBS-PC documentation.  Each questionnaire is named with a filename of up to
  221. eight characters with a mandatory extension of .DEF.  Questionnaires which will
  222. be summarized with QESSUMRY 3.0 must follow these guidelines:
  223.  
  224.           1.  The data file where the questionnaire responses are recorded MUST
  225.           have an extension of .DAT  .  The Questions & Answers and User
  226.           Response Statistics options of QESSUMRY 3.0 require that both the
  227.           .DAT and .DEF files have the same file name.  If used, the answer
  228.           file must also have the same filename.
  229.  
  230.                Therefore, the data file for TRIVIA.DEF (the questionnaire)
  231.                would have a data file named TRIVIA.DAT and an optional answer
  232.                file named TRIVIA.ANS.
  233.  
  234.           2.  Multiple choice and yes/no questions MUST be designated by the
  235.           label "QUESTION", followed by a one or two digit question number.  It
  236.           is preferable, but not necessary, that single-digit question numbers
  237.           by preceded by a zero.  According to the questionnaire development
  238.           criteria for RBBS-PC, labels are indicated by a colon (:).
  239.  
  240.                Therefore, multiple choice question number 2 would be labeled
  241.                :QUESTION2  or  :QUESTION02
  242.  
  243.                To avoid conflicts, questions requiring text input should have a
  244.                label other than "QUESTIONxx".  See Examples.
  245.  
  246.           3.  QESSUMRY 3.0 will summarize up to 15 multiple-choice or yes/no
  247.           questions per questionnaire, each with up to 8 choices.  Multiple
  248.           choice responses must be in the range A-H.  QESSUMRY 3.0 is not case-
  249.           sensitive to responses, so both upper and lower case responses are
  250.           acceptable.  Yes/no questions must have the "yes" response listed
  251.           first.  (Responses must be Y/N - True/False or T/F responses are not
  252.           supported by QESSUMRY.)
  253.  
  254.           4.  For all functions of QESSUMRY 3.0 to work properly, the response
  255.           line (the one preceded with a "?") should be separate from the
  256.           question itself.  Although this is not mandatory, if you design
  257.           questions using the single question/response line, the (Q)uestion &
  258.           Answer facility will not pick up the question.  
  259.  
  260.                     ?Do you own an IBM PC  (Y/N)
  261.  
  262.                would be better written as:
  263.  
  264.                     *Do you own an IBM PC
  265.                     ?Enter Y or N
  266.  
  267.  
  268.                Response lines should have the valid responses listed.  The last
  269.           character should be either the highest response letter or, in the
  270.           case of yes/no questions the close-parenthesis is acceptable.
  271.  
  272.                A proper response line for a 5 answer multiple choice would be:
  273.  
  274.                     ?Enter A, B, C, D or E
  275.  
  276.                Proper response lines for a yes/no question would be:
  277.  
  278.                     ?Enter Y or N
  279.                          or
  280.                     ?Enter (Y/N)
  281.  
  282.      See Appendix A for a sample <filename>.DEF file.
  283.  
  284.  
  285.  
  286.                               RUNNING THE PROGRAM
  287.  
  288.      QESSUMRY 3.0 is a stand-alone executable program.  It must exist on the
  289. same drive/subdirectory as the questionnaire data file.  If you wish to use the
  290. Questions & Answers option, the <filename>.DEF file for the questionnaire must
  291. also exist on the same drive/subdirectory.  Additionally, <filename> in
  292. <filename>.DAT and <filename>.DEF files must be identical. 
  293.  
  294.  
  295. Variation 1:
  296.  
  297.      To start the program, type QESSUMRY at the DOS prompt.  QESSUMRY 3.0 will
  298. display its intro logo and ask for the name of the questionnaire data file. 
  299. You may enter either the filename alone, or with the extension of .DAT.  If the
  300. filename is entered without an extension, QESSUMRY 3.0 will append .DAT to the
  301. filename.
  302.  
  303.      You will then be asked whether you want the output routed to a Database
  304. file, Text file, Printer or whether you want to Summarize the Questionnaire. 
  305. The default is to a text file.  See OUTPUT OPTIONS. 
  306.  
  307. Variation 2:
  308.  
  309.      QESSUMRY 3.0 may also be started by placing the output selection and
  310. filename on the command line.  The output selection follows the program name
  311. and is indicated by either "-" or "/".  The data filename follows the output
  312. selection, and does NOT include an extension.
  313.  
  314.      Valid output selections are: -A, -D, -P, -Q, and -U (/A, /D, /P, /Q, /U).
  315.  
  316. Example:  C:> QESSUMRY -D 300BAUD   will output the tally of responses to
  317. 300BAUD.DAT to a delimited data file called 300BAUD.DTA.
  318.  
  319.           C:> QESSUMRY /p upload will output the tally of responses to
  320. TRIVIA.DAT to the printer.
  321.  
  322.      NOTE:  If you use the command line option, you MUST include both the
  323. output specification and the filename.  You cannot omit either, and they must
  324. appear in the correct order.  Command line entries are not case-sensitive.
  325.  
  326.  
  327.  
  328.                                 OUTPUT OPTIONS
  329.  
  330.                                  [A]SCII File
  331.  
  332.      The default output option is to a text file with the name <filename>.TXT. 
  333. This will create an ASCII text file on the default drive/subdirectory contain-
  334. ing the number of responses and a percentage breakdown of each response.  (In
  335. previous versions, this option was labeled "Text [F]ile", and the output was to
  336. a file with the extension ".FIL".  This has been changed to provide more
  337. uniformity with other available questionnaire programs.)
  338.  
  339.  
  340.  
  341.                                    (P)rinter
  342.  
  343.      If you select Printer, QESSUMRY 3.0 will direct its output to your default
  344. printer.  This output will be in the same form as the text file output, but
  345. will be formatted to break properly on 11 inch paper.
  346.  
  347.  
  348.  
  349.                                 (D)atabase File
  350.  
  351.      If you select this option, QESSUMRY 3.0 will direct its output to a file
  352. called <filename>.DTA.  There will be one text line for each question in the
  353. questionnaire.  The file format is:
  354.           1) The word "QUESTION" followed by the question number 
  355.           2) the total number of responses to that question 
  356.           3-10) the number of responses to each choice A-H.  If the question is
  357.           a yes/no, "Y" responses will be in field 3 and "N" responses in field
  358.           4.  Fields are delimited by commas.  
  359.  
  360.      NOTE:  This output is NOT of itself in any particular database format.  It
  361. is merely in the delimited format which can be imported by various database
  362. programs.
  363.  
  364.  
  365.  
  366.                              (Q)uestions & Answers
  367.  
  368.      In QESSUMRY 2.0, this option was designated as (S)ummarize Questionnaire. 
  369. The output of this option is to a text file named <filename>.SUM.
  370.  
  371.      If you select Questions & Answers, QESSUMRY 3.0 will tally the responses,
  372. as it does with the other options.  In its basic output form, QESSUMRY 3.0 will
  373. print each question (those defined by the :QUESTION label), followed by a
  374. summary of the responses for that question.  You will have the options of
  375. supplying "correct" answers for the questions and/or to provide explanations
  376. for the questions and answers.
  377.  
  378.  
  379. Supplying "Correct" Answers
  380.  
  381.      QESSUMRY 3.0 will check for the existence of a file called <filename>.ANS. 
  382. This is the answer file for those questionnaires where there is a "correct"
  383. answer for each question.  If this file is located on the default drive/sub-
  384. directory, QESSUMRY 3.0 will insert the correct answers into the output file.
  385.  
  386.      The answer file may have correct answers on one line, delimited by commas,
  387. or may have each answer on a separate line.  NOTE:  It is your responsibility
  388. to ensure that there are the proper number of answers for the number of
  389. questions in the questionnaire.  QESSUMRY 3.0 will terminate abnormally if
  390. there are too few answers in the <filename>.ANS file for the number of
  391. questions.  Valid entries for the <filename>.ANS file are Y, N, or A-H. 
  392. Entries are not case-sensitive.  If you use the automatic .ANS file creation
  393. option, explained in the next paragraph, the proper file format will be
  394. created.
  395.  
  396.      If no <filename>.ANS file exists, you will be asked if you wish to provide
  397. "correct" answers to the questions.  If the questionnaire is of the general
  398. survey type where there is no "right" answer to the question, press "N".  If
  399. you do wish to provide "correct" answers, such as to a knowledge questionnaire,
  400. press "Y".  You will then be asked if you wish to have answers written to an
  401. .ANS file.  If you respond "Y", QESSUMRY 3.0 will create an .ANS file for the
  402. questionnaire from the answers you input on the screen.  QESSUMRY 3.0 will then
  403. display each question in the questionnaire and prompt you for the correct
  404. answer.  In this form, only a one character response is accepted, but the
  405. responses are not case-sensitive.  
  406.  
  407.      See appendix B for a sample answer file.
  408.  
  409.  
  410. Supplying an Explanation to Questions
  411.  
  412.      QESSUMRY 3.0 will check for the existence of an explanation file -
  413. <filename>.EXP.  If <filename>.EXP does not exist, you will be asked if you
  414. wish to supply an explanation for the questions.
  415.  
  416.      If <filename>.EXP does not exist, you will be presented with a format for
  417. entering the explanations after the display of each question.  Explanations
  418. must not be longer than 10 lines of 72 characters each.  NOTE:  Lines longer
  419. than 72 characters will be truncated to 72 characters in length.  The format
  420. indicates the proper length.  To end the explanation entry, press {ENTER} on a
  421. blank line.
  422.  
  423.      To skip an explanation for any individual question, press {ENTER} on the
  424. first line of the explanation entry format.
  425.  
  426.  
  427. Format of <filename>.EXP
  428.  
  429.      Explanations may be provided through the use of an explanation file, named
  430. <filename>.EXP.  It is critical that the <filename>.EXP file follow the proper
  431. format.  The first explanation must start of the first line of the file, and
  432. explanations may be no longer than 10 lines.  (Line length may be up to 79
  433. characters, unlike the on-line entry which are limited to 72 characters.)
  434.  
  435.      Explanations are delimited by a percent character (%) in the first
  436. position of a line.  The remainder of a limit line may be used for comments.
  437.  
  438.      Questions for which no explanation is desired must still be accounted for
  439. in the file, and the file must end with a percent character (%).  NOTE:  There
  440. will be the same number of percent characters in the first column as there are
  441. questions.  See appendix C for a sample explanation file.
  442.  
  443.      If no <filename>.EXP file exists on the default drive\subdirectory and you
  444. have indicated that you wish to provide explanations, QESSUMRY 3.0 will ask if
  445. you wish to create <filename>.EXP.  If you do, QESSUMRY 3.0 will write the
  446. explanation entered on the screen to <filename>.EXP for future use.
  447.  
  448.      See Appendix F for a sample question & answer summary file.
  449.  
  450.  
  451.  
  452.                           (U)ser Response Statistics
  453.  
  454.      When a questionnaire has "correct" answers, the sysop or users may want to
  455. know how many questions each user answered correctly, and which questions the
  456. user missed.  This option creates such a summary, output to a file called
  457. <filename>.URS.  For this option to function properly, <filename>.ANS must be
  458. present on the default drive\subdirectory.
  459.  
  460.      See Appendix G for a sample user response file.
  461.  
  462.  
  463.  
  464.                            Overwriting Output Files
  465.  
  466.      <filename>.TXT, <filename>.DTA, <filename>.SUM, and <filename>.URS files
  467. will be over-written each time their option is selected.  
  468.  
  469.  
  470.  
  471.                            Explanation of Appendices
  472.  
  473.      The following appendices present examples of the files discussed in this
  474. documentation.  For clarity, the actual file is separated from any discussion
  475. by 10 dots, centered on the page.
  476.  
  477.                               . . . . . . . . . .
  478.  
  479.      These are NOT part of the file, just a way to show the limits of the file
  480. presented.                                  Appendix A - Sample Definition File
  481.                                                                      TRIVIA.DEF
  482.  
  483.  
  484.      Following is a sample questionnaire definition file.  The outputs listed
  485. in Appendices D, E, and F are derived from this file, and it's accompanying
  486. data (.DAT) file and optional answer (.ANS) and explanation (.EXP) files.
  487.  
  488.                               . . . . . . . . . .
  489. "TRIVIA.DAT",10
  490. *                           TRIVIA TEST #1
  491. *
  492. *
  493. :QUESTION1
  494. *
  495. *
  496. *
  497. *
  498. *The most famous stage play of 1865 was
  499. *( A ) - "Johnny Comes Marching Home", starring Edwin Booth
  500. *( B ) - "Our American Cousin", starring Laura Keene
  501. *( C ) - "The Great Train Robbery"
  502. *( D ) - "Freedom, Freedom", starring Frederick Douglass
  503. ?Choose A, B, C or D
  504. =AQUESTION2=BQUESTION2=CQUESTION2=DQUESTION2= QUESTION1E
  505. :QUESTION1E
  506. *Please respond A, B, C or D
  507. >QUESTION1
  508. :QUESTION2
  509. *
  510. *
  511. *
  512. *
  513. *Disneyland opened to the public in
  514. *( A ) - 1974
  515. *( B ) - 1950
  516. *( C ) - 1955
  517. *( D ) - 1962
  518. ?Choose A, B, C or D
  519. =AQUESTION3=BQUESTION3=CQUESTION3=DQUESTION3= QUESTION2E
  520. :QUESTION2E
  521. *Please respond A, B, C or D
  522. >QUESTION2
  523. :QUESTION3
  524. *
  525. *
  526. *
  527. *
  528. *In World War I, Japan was
  529. *( A ) - Allied with Germany and Prussia
  530. *( B ) - Neutral
  531. *( C ) - Fighting a separate war against Russia
  532. *( D ) - Allied with the United States and England
  533. ?Choose A, B, C or D =AQUESTION4=BQUESTION4=CQUESTION4=DQUESTION4= QUESTION3E
  534. :QUESTION3E
  535. *Please respond A, B, C or D
  536. >QUESTION3
  537. :QUESTION4
  538. *
  539. *
  540. *
  541. *
  542. *The only man to serve two non-consecutive terms as U.S. President was
  543. *( A ) - James Monroe
  544. *( B ) - Grover Cleveland
  545. *( C ) - Franklin D. Roosevelt
  546. *( D ) - William Jennings Bryan
  547. *( E ) - Thomas Jefferson
  548. ?Choose A, B, C, D or E
  549. =AQUESTION5=BQUESTION5=CQUESTION5=DQUESTION5=EQUESTION5= QUESTION4E
  550. :QUESTION4E
  551. *Please respond A, B, C, D or E
  552. >QUESTION4
  553. :QUESTION5
  554. *
  555. *
  556. *
  557. *
  558. *The IBM Personal Computer was released in
  559. *( A ) - 1979
  560. *( B ) - 1981
  561. *( C ) - 1983
  562. *( D ) - 1977
  563. *( E ) - 1965
  564. ?Choose A, B, C, D or E
  565. =ACHECK=BCHECK=CCHECK=DCHECK=ECHECK= QUESTIONE
  566. :QUESTION5E
  567. *Please respond A, B, C, D or E
  568. >QUESTION5
  569. :CHECK
  570. *
  571. *
  572. *
  573. *
  574. ?Have you answered the Questionnaire before ? (Y/N)
  575. =YABORT=NEXIT= CHECKE
  576. :CHECKE
  577. *Please respond Y or N
  578. >CHECK
  579. :ABORT
  580. @
  581. :EXIT
  582.                               . . . . . . . . . .
  583.  
  584.      NOTE:  The question labeled CHECK is a 'housekeeping' question, and will
  585. not be included in the summaries, since the label does not begin with :QUESTION
  586.                                               Appendix B - Sample Answer Files
  587.                                                                      TRIVIA.ANS
  588.  
  589.  
  590.      This appendix lists the two variations of an answer file.  In the first,
  591. answers are entered on separate lines.  In the second, all answers are entered
  592. on one line, delimited by commas.  The file name for both files would be
  593. <filename>.ANS, or in this specific example, TRIVIA.ANS.
  594.  
  595.                               . . . . . . . . . .
  596. b
  597. c
  598. d
  599. b
  600. b
  601.                               . . . . . . . . . . 
  602. B,C,D,B,B
  603.                               . . . . . . . . . .
  604.  
  605.      NOTE:  Answers may be either upper or lower case.
  606.                                           Appendix C - Sample Explanation File
  607.                                                                      TRIVIA.EXP
  608.  
  609.      This is an example of an explanation file, used when there are "correct"
  610. answers for questions, and you wish to explain why an answer is correct.
  611.  
  612.      NOTE that there is no percent mark starting the file, but that each
  613. explanation is separated by a percent mark.  The name and number of the
  614. question follow questions 2 & 3, showing that the limit line may be used as a
  615. reference line for comments.  This is eliminated in question 4 to show that
  616. comments are not required, although the limit character (%) is.  Explanations
  617. are no longer than 10 lines each, and do not contain blank lines.
  618.  
  619.      NOTE also that, although no explanation is provided for question 5, its
  620. position is still maintained by a limit mark, and that the file ends with a
  621. limit mark.  See Appendix F for the sample summary output file to see what this
  622. produces.
  623.  
  624.                               . . . . . . . . . .
  625.     "Our American Cousin" was an immensely popular play starring the English
  626. actress Laura Keene.  It gained even greater notoriety because it was playing
  627. at Ford's Theatre in Washington, D.C. on April 14, 1865.  On that night, one of
  628. the audience, President Abraham Lincoln, was assassinated during the play.
  629. %Question 2
  630.     Disneyland opened to the public on July 17, 1955, exactly one year after
  631. construction began.
  632. %QUESTION 3
  633.     In World War I, Japan sided with the Allies against Germany.  (The Russo-
  634. Japanese occurred about ten years earlier, in 1904-1905)
  635. %
  636.     Grover Cleveland served as the 22nd and 24th Presidents of the United
  637. States.
  638. %QUESTION 5
  639. %This is the end of file limit mark
  640.  
  641.                               . . . . . . . . . .
  642.  
  643.      NOTE that the file ends with a limit mark (%).  These are necessary for
  644. proper operation of the program.
  645.  
  646.                                          Appendix D - Sample ASCII Output File
  647.                                                                      TRIVIA.TXT
  648.  
  649.      This is a sample of the file produced when the [A]SCII File option is
  650. taken.  This same format is routed to the printer when that option is taken.
  651.  
  652.  
  653.                               . . . . . . . . . .
  654. QESSUMRY (c)                      TRIVIA.DAT                        06-22-1988
  655. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::     19:57 
  656.  
  657. Question 1                                                 Total Answers:   13
  658.  
  659.          Choice         # Responding                 Percentage
  660.  
  661.          A:                    4                       30.77 %
  662.          B:                    3                       23.08 %
  663.          C:                    4                       30.77 %
  664.          D:                    2                       15.38 %
  665. .............................................................................. 
  666.  
  667. Question 2                                                 Total Answers:   13
  668.  
  669.          Choice         # Responding                 Percentage
  670.  
  671.          A:                    0                        0.00 %
  672.          B:                    2                       15.38 %
  673.          C:                    5                       38.46 %
  674.          D:                    5                       38.46 %
  675. .............................................................................. 
  676.  
  677. Question 3                                                 Total Answers:   13
  678.  
  679.          Choice         # Responding                 Percentage
  680.  
  681.          A:                    3                       23.08 %
  682.          B:                    4                       30.77 %
  683.          C:                    5                       38.46 %
  684.          D:                    1                        7.69 %
  685. .............................................................................. 
  686.  
  687. Question 4                                                 Total Answers:   13
  688.  
  689.          Choice         # Responding                 Percentage
  690.  
  691.          A:                    4                       30.77 %
  692.          B:                    3                       23.08 %
  693.          C:                    3                       23.08 %
  694.          D:                    0                        0.00 %
  695.          E:                    3                       23.08 %
  696. .............................................................................. 
  697.  
  698. Question 5                                                 Total Answers:   13
  699.  
  700.          Choice         # Responding                 Percentage
  701.  
  702.          A:                    4                       30.77 %
  703.          B:                    3                       23.08 %
  704.          C:                    3                       23.08 %
  705.          D:                    1                        7.69 %
  706.          E:                    2                       15.38 %
  707. .............................................................................. 
  708.                             Appendix E - Sample Delimited Database Output File
  709.                                                                      TRIVIA.DTA
  710.  
  711.                                        
  712. Question 1 , 13 , 4 , 3 , 4 , 2 , 0 , 0 , 0 , 0  
  713. Question 2 , 13 , 0 , 2 , 5 , 5 , 0 , 0 , 0 , 0  
  714. Question 3 , 13 , 3 , 4 , 5 , 1 , 0 , 0 , 0 , 0  
  715. Question 4 , 13 , 4 , 3 , 3 , 0 , 3 , 0 , 0 , 0  
  716. Question 5 , 13 , 4 , 3 , 3 , 1 , 2 , 0 , 0 , 0  
  717.  
  718.                                  Appendix F - Sample Question & Answer Summary
  719.                                                                      TRIVIA.SUM
  720.  
  721.      The ultimate output from the QESSUMRY program, this file integrates the
  722. questions, correct answers, explanation, and answer summary in one file output.
  723.  
  724.  
  725.      NOTE that no explanation is provided for Question 5 in this example:  See
  726. appendix C, above.
  727.  
  728.  
  729.                               . . . . . . . . . .
  730. Question 1 : 
  731.   
  732. The most famous stage play of 1865 was 
  733. ( A ) - "Johnny Comes Marching Home", starring Edwin Booth 
  734. ( B ) - "Our American Cousin", starring Laura Keene 
  735. ( C ) - "The Great Train Robbery" 
  736. ( D ) - "Freedom, Freedom", starring Frederick Douglass 
  737.   
  738.      The CORRECT answer is [B] 
  739.   
  740.                    ======================================== 
  741.   
  742.                          EXPLANATION for Question  1 
  743.   
  744.     "Our American Cousin" was an immensely popular play starring the English 
  745. actress Laura Keene.  It gained even greater notoriety because it was 
  746. playing at Ford's Theatre in Washington, D.C. on April 14, 1865.  On that 
  747. night, one of the audience, President Abraham Lincoln, was assassinated  during
  748. the play. 
  749.   
  750.                    ++++++++++++++++++++++++++++++++++++++++ 
  751.   
  752. Question 1                                                 Total Answers:   13
  753.  
  754.  
  755.          Choice         # Responding                 Percentage 
  756.   
  757.          A:                    4                       30.77 % 
  758.          B:                    3                       23.08 % 
  759.          C:                    4                       30.77 % 
  760.          D:                    2                       15.38 % 
  761. ..............................................................................
  762.  
  763.   
  764. Question 2 : 
  765.   
  766. Disneyland opened to the public in 
  767. ( A ) - 1974 
  768. ( B ) - 1950 
  769. ( C ) - 1955 
  770. ( D ) - 1962 
  771.   
  772.      The CORRECT answer is [C] 
  773.   
  774.                    ======================================== 
  775.   
  776.                          EXPLANATION for Question  2 
  777.   
  778.     Disneyland opened to the public on July 17, 1955, exactly one year after 
  779. construction began. 
  780.   
  781.                    ++++++++++++++++++++++++++++++++++++++++ 
  782.   
  783. Question 2                                                 Total Answers:   13
  784.  
  785.  
  786.          Choice         # Responding                 Percentage 
  787.   
  788.          A:                    0                        0.00 % 
  789.          B:                    2                       15.38 % 
  790.          C:                    5                       38.46 % 
  791.          D:                    5                       38.46 % 
  792. ..............................................................................
  793.  
  794.   
  795. Question 3 : 
  796.   
  797. In World War I, Japan was 
  798. ( A ) - Allied with Germany and Prussia 
  799. ( B ) - Neutral 
  800. ( C ) - Fighting a separate war against Russia 
  801. ( D ) - Allied with the United States and England 
  802.   
  803.      The CORRECT answer is [D] 
  804.   
  805.                    ======================================== 
  806.   
  807.                          EXPLANATION for Question  3 
  808.   
  809.     In World War I, Japan sided with the Allies against Germany.  (The 
  810. Russo-Japanese occurred about ten years earlier, in 1904-1905) 
  811.   
  812.                    ++++++++++++++++++++++++++++++++++++++++ 
  813.   
  814. Question 3                                                 Total Answers:   13
  815.  
  816.  
  817.          Choice         # Responding                 Percentage 
  818.   
  819.          A:                    3                       23.08 % 
  820.          B:                    4                       30.77 % 
  821.          C:                    5                       38.46 % 
  822.          D:                    1                        7.69 % 
  823. ..............................................................................
  824.  
  825.   
  826. Question 4 : 
  827.   
  828. The only man to serve two non-consecutive terms as U.S. President was 
  829. ( A ) - James Monroe 
  830. ( B ) - Grover Cleveland 
  831. ( C ) - Franklin D. Roosevelt 
  832. ( D ) - William Jennings Bryan 
  833. ( E ) - Thomas Jefferson 
  834.   
  835.      The CORRECT answer is [B] 
  836.   
  837.                    ======================================== 
  838.   
  839.                          EXPLANATION for Question  4 
  840.   
  841.     Grover Cleveland served as the 22nd and 24th Presidents of the United 
  842. States. 
  843.   
  844.                    ++++++++++++++++++++++++++++++++++++++++ 
  845.   
  846. Question 4                                                 Total Answers:   13
  847.  
  848.  
  849.          Choice         # Responding                 Percentage 
  850.   
  851.          A:                    4                       30.77 % 
  852.          B:                    3                       23.08 % 
  853.          C:                    3                       23.08 % 
  854.          D:                    0                        0.00 % 
  855.          E:                    3                       23.08 % 
  856. ..............................................................................
  857.  
  858.   
  859. Question 5 : 
  860.   
  861. The IBM Personal Computer was released in 
  862. ( A ) - 1979 
  863. ( B ) - 1981 
  864. ( C ) - 1983 
  865. ( D ) - 1977 
  866. ( E ) - 1965 
  867.   
  868.      The CORRECT answer is [B] 
  869.   
  870.                    ======================================== 
  871.   
  872. Question 5                                                 Total Answers:   13
  873.  
  874.  
  875.          Choice         # Responding                 Percentage 
  876.   
  877.          A:                    4                       30.77 % 
  878.          B:                    3                       23.08 % 
  879.          C:                    3                       23.08 % 
  880.          D:                    1                        7.69 % 
  881.          E:                    2                       15.38 % 
  882. ..............................................................................
  883.                                   Appendix G - Sample User Response Statistics
  884.                                                                      TRIVIA.URS
  885.  
  886.      The following User Response Statistics file was taken from another trivia
  887. questionnaire, to which there were ten questions.  The respondent's name has
  888. been replaced with RESPONDENT'S NAME #x for this documentation to protect the
  889. actual users.  For space conservation, only five of the responses are listed
  890. here, although the summary of responses is shown.
  891.  
  892.  
  893.  
  894. QESSUMRY (c)                      TRIVIA.DAT                        06-16-1988
  895. ::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::     09:23
  896.                            User Response Statistics
  897.  
  898.  
  899. RESPONDENT'S NAME #1
  900.      got [ 4 ] answers right out of [ 10 ] for a score of 40.0%
  901.           Questions missed: 1 2 3 6 8 9 
  902.  
  903.  
  904. RESPONDENT'S NAME #2 
  905.      got [ 3 ] answers right out of [ 10 ] for a score of 30.0%
  906.           Questions missed: 2 3 4 5 6 8 9 
  907.  
  908.  
  909. RESPONDENT'S NAME #3 
  910.      got [ 7 ] answers right out of [ 10 ] for a score of 70.0%
  911.           Questions missed: 1 2 10 
  912.  
  913.  
  914. RESPONDENT'S NAME #4 
  915.      got [ 6 ] answers right out of [ 10 ] for a score of 60.0%
  916.           Questions missed: 3 5 6 8 
  917.  
  918.  
  919. RESPONDENT'S NAME #5
  920.      got [ 1 ] answers right out of [ 10 ] for a score of 10.0%
  921.           Questions missed: 1 2 4 5 6 7 8 9 10 
  922.  
  923.                               . . . . . . . . . .
  924.  
  925. -------------------------------------------------------------------------------
  926.  
  927.  84 users got a total of 463 answers right for an average score of 55.12%
  928.  
  929.  
  930.                                REGISTRATION FORM
  931.                                  QESSUMRY 3.0
  932.  
  933.  
  934.  
  935. Name:___________________________________________________________
  936.  
  937. Address:________________________________________________________
  938.  
  939. City:____________________    State:______    Zip Code:__________
  940.  
  941.  
  942. Are you a SYSOP of an operating BBS?  ( ) Yes        ( ) No
  943.  
  944. If Yes, what is the data phone number for the BBS? ___________________
  945.  
  946.  
  947. Where did you obtain your copy of QESSUMRY?  ________________________________
  948.  
  949. If from a BBS, what is the name and number of the BBS? ______________________
  950.  
  951.  
  952.  
  953. Enclose $15.00 Registration fee.
  954.  
  955.  
  956. Complete and send to:
  957.  
  958.                                 R. Mike Worley
  959.                                 P.O. Box 45321
  960.                                Boise, ID  83711
  961.  
  962.  
  963.                                      INDEX
  964.  
  965. <filename>
  966.      Explanation of designation  . . . . . . . . . . . . . . . . . . . . . .  4
  967. Answer file  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  968. ASCII text file  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  969. Bulletin boards  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  970. Correct answers  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  971.      Explanation of  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  972. Delimit
  973.      Character, file . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 7
  974.      Data file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2, 7
  975.      In <filename>.ANS . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  976.      In <filename>.EXP . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  977. Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4
  978. Explanation file
  979.      Format of . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  980. File Extensions
  981.      .ANS  . . . . . . . . . . . . . . . . . . . . . . . . .  3-5, 8, 9, 11, 13
  982.      .DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  4-6, 11
  983.      .DEF  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2, 4-6
  984.      .DTA  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 7, 10
  985.      .EXP  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3, 4, 9, 11
  986.      .SUM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 8, 10
  987.      .TXT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4, 7, 10
  988.      .URS  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  3, 5, 9, 10
  989. File Extensions, Old
  990.      .FIL  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  991. Length
  992.      <filename>.EXP file . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  993.      <filename>.EXP lines  . . . . . . . . . . . . . . . . . . . . . . . . .  9
  994.      Explanation screen lines  . . . . . . . . . . . . . . . . . . . . . . .  9
  995. NOTE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9, 12-14, 18
  996. Options Requirements
  997.      Answer file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  998.      Questions & Answers . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  999.      Response line . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  1000.      User Response Statistics  . . . . . . . . . . . . . . . . . . . . . . .  5
  1001. Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1002.      ASCII (Text) File . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1003.      Database File . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1004.      Delimited Data File . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1005.      Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2
  1006. Output selections
  1007.      Valid (for command line)  . . . . . . . . . . . . . . . . . . . . . . .  7
  1008. Printer  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1009. Questionnaires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1010.      Guidelines  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1011. RBBS-PC  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  1012.      RBBS  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  2, 4, 5
  1013. REGISTRATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1014.      FORM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
  1015. Running the program
  1016.      Variation 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  6
  1017.      Variation 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  1018. Sample files
  1019.      Answer  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  1020.      ASCII . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  1021.      Definition  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  1022.      Delimited Database  . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  1023.      Explanation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  1024.      Question & Answer . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  1025.      User Response Summary . . . . . . . . . . . . . . . . . . . . . . . . . 22
  1026. Shareware  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1027. Summarize Questionnaire
  1028.      (S)ummarize Questionnaire . . . . . . . . . . . . . . . . . . . . . . .  8
  1029. Truncation
  1030.      <filename>.EXP lines  . . . . . . . . . . . . . . . . . . . . . . . . .  9
  1031. WARRANTY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  1032.